home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 47.7z / BS1 part 47 / ImageMaster RT v1.50b (1994)(Black Belt Systems)(Disk 4 of 7)[HD].7z / ImageMaster RT v1.50b (1994)(Black Belt Systems)(Disk 4 of 7)[HD].adf / apa.lzh.parta / hlp_arexx9 < prev    next >
Text File  |  1994-04-19  |  22KB  |  931 lines
  1. \ApAssist
  2. \: - This is the Quick Help for the ARexx in IM R/t -
  3. \: ----------------------------------------------------------
  4. \:   Written by David E. Patterson
  5. \: ----------------------------------------------------------
  6.  
  7. \font topaz.font 8
  8. \tc 1
  9. \wr
  10. \lj
  11. \dd "imh_descriptor"
  12.  
  13. \index "hlp_arexx2/merge-pad"
  14. \toc "imh_toc/toc"
  15. \help "aa_help/help
  16.  
  17. \node "mono"
  18. \title "Mono"
  19. \next "move"
  20. \prev ""
  21. \{ \tc 15 Mono \} - Changes a selected area to the monochrome equivalent B&W.
  22.  
  23. \nw    
  24. Usage - '\{ \tc 15 mono\} '
  25.     
  26. \{ \ts bu Sample Script\} :
  27.     
  28. 'area';
  29. '\{ \tc 15 mono\} ';
  30.     
  31. See Also: \{ \ts b \link "negmono" "negmono"\}
  32.     
  33. * User Interface: \{ \tc 15   Process Panel
  34.                         Special Effects
  35.                             Mono\}
  36.     
  37. \endnode
  38.  
  39. \node "move"
  40. \title "Move"
  41. \next "multifill"
  42. \prev "mono"
  43. \{ \tc 15 Move \} - This command is used to move the position of the current
  44. paint brush.  This command is used in conjunction with the newline, draw, and
  45. stroke commands for painting in Imagemaster R/t using ARexx.  The move
  46. command can be though of as the starting position for a line.  The move
  47. command will reposition the current brush with out drawing aline.  This
  48. command can be considered as a pen up movement for brushes.  You can use the 
  49. move and draw commands with multiple x and y coordinates to create complex
  50. lines and shapes.  Once the line is complete you should use the stroke
  51. command to actually draw the line.  The newline command can be used to create
  52. a seperate line that will use its own move, draw, and stroke commands.
  53.  
  54. \nw    
  55. Usage - '\{ \tc 15 move <X> <Y>\} '
  56.  
  57. Where X and Y represent the initial position for the line on the image.
  58.  
  59. \{ \ts bu Sample Script\} :
  60. /* arexx Painting Example */
  61. address('IM_Port');
  62. options results;
  63. 'askprop "Initial X Position: " 100 0 320';
  64. x1 = result;
  65. 'askprop "Initial Y Position: "100 0 200';
  66. y1 = result;
  67. 'askprop "Final X Position: " 100 0 320';
  68. x2 = result;
  69. 'askprop "Final Y Position: " 100 0 200';
  70. y2 = result;
  71. 'askprop "Specify the Pressure Amount: " 100 0 255';
  72. press = result;
  73. options;
  74. 'newline';
  75. '\{ \tc darkblue move\} ' x1 y1;
  76. 'draw ' x2 y2 press;
  77. 'stroke';
  78. 'finish';
  79.  
  80. Related ARexx Commands: \{ \ts b \link "newline" "newline"
  81.                         \link "  draw " "imdoc:hlp_arexx6/draw"
  82.                         \link " stroke" "imdoc:hlp_arexx11/stroke" \}
  83.  
  84. * User Interface: \{ \tc 15   Paint Panel
  85.                          Line Draw\}
  86.  
  87. \endnode
  88.  
  89. \node "multifill"
  90. \title "MultiFill"
  91. \next "multiscript"
  92. \prev "move"
  93. \{ \tc 15 Multifill \} - Creates a complex gradient fill.
  94.  
  95. Creates a complex gradient fill.  Uses colors set by the 'setmulti' function.
  96. Uses the current blend settings.
  97.  
  98. \nw    
  99. Usage - '\{ \tc 15 multifill <direction>\} '
  100.     
  101. \{ \tc 15 Direction:  0 = Two way horizontal
  102.             1 = two way vertical
  103.             2 = horizontal + center
  104.             3 = vertical + center
  105.             4 = four way
  106.             5 = four way + center\}
  107.     
  108. \{ \ts bu Sample Script\} :
  109.     
  110. 'area';
  111. '\{ \tc 15 multifill 5\} ';
  112.     
  113. * User Interface: \{ \tc 15   Process Panel
  114.                         Special Effects 
  115.                             Grad Fill\}
  116.  
  117. \endnode
  118.  
  119. \node "multiscript"
  120. \title "Multiscript"
  121. \next "negcolor"
  122. \prev "multifill"
  123. \{ \tc 15 Multiscript \} - Allows you to specify the four ARexx scripts for
  124. the multi-frame sequencer.
  125.  
  126. \nw    
  127. Usage - '\{ \tc 15 multiscript [Open=opening] [PRE=prerender]
  128.         [Post=postrender] [close=closing]'\} ' 
  129.     
  130. \{ \ts b Open= \} : This allows you to specify the opening script for the
  131. sequence.
  132.  
  133. \{ \ts b Pre= \} : This allows you to specify the pre-render script for the
  134. sequence.
  135.  
  136. \{ \ts b Post= \} : This allows you to specify the post-render script for the
  137. sequence.
  138.  
  139. \{ \ts b Close= \} : This allows you to specify the closing script for the
  140. sequence.
  141.  
  142. \{ \ts bu Sample Script\} :
  143.     
  144. '\{ \tc 15 multiscript Open=rxpi:animwr1.rexx Pre=rexx:contrast.rexx
  145. Post=rxpi:animwr3.rexx Close=rxpi:animwr4.rexx\} '
  146.  
  147. * User Interface: \{ \tc 15   File I/O Panel
  148.                         Multi-Frame Sequencer 
  149.                             Set Scripts\}
  150.  
  151. See Also: \{ \ts b \nw \link "More on the Multi-Frame Sequencer" "mf_hlp/mf_multiframe"\}
  152.  
  153. \endnode
  154.  
  155. \node "negcolor"
  156. \title "Negative Color"
  157. \next "negluma"
  158. \prev "multiscript"
  159. \{ \tc 15 Negcolor \} - Creates a color negative of a selected area.
  160.  
  161. \nw    
  162. Usage - '\{ \tc 15 negcolor\} '
  163.     
  164. \{ \ts bu Sample Script\} :
  165.     
  166. 'area';
  167. '\{ \tc 15 negcolor\} ';
  168.     
  169. * User Interface: \{ \tc 15   Process Panel
  170.                         Special Effects
  171.                             Color Neg\}
  172.  
  173. \endnode
  174.  
  175. \node "negluma"
  176. \title "Negative Luma"
  177. \next "negmono"
  178. \prev "negcolor"
  179. \{ \tc 15 Negluma \} - Creates a luma negative of a selected area.
  180.  
  181. \nw    
  182. Usage - '\{ \tc 15 negluma\} '
  183.     
  184. \{ \ts bu Sample Script\} :
  185.       
  186. 'area';
  187. '\{ \tc 15 negluma\} ';
  188.    
  189. See Also: \{ \ts b \link "luma" "hlp_arexx8/luma"\}
  190.    
  191. * User Interface: \{ \tc 15    Process Panel
  192.                           Special Effects
  193.                              Luma Neg\}
  194.  
  195. \endnode
  196.  
  197. \node "negmono"
  198. \title "Negative Mono"
  199. \next "net"
  200. \prev "negluma"
  201. \{ \tc 15 Negmono \} - Creates a monochrome negative of a selected area.
  202.  
  203. \nw    
  204. Usage - '\{ \tc 15 negmono\} '
  205.     
  206. \{ \ts bu Sample Script\} :
  207.     
  208. 'area';
  209. '\{ \tc 15 negmono\} ';
  210.     
  211. See Also: \{ \ts b \link "mono" "hlp_arexx9/mono"\}  
  212.     
  213. * User Interface: \{ \tc 15   Process Panel
  214.                         Special Effects
  215.                            Mono Neg\}
  216.                            
  217. \endnode
  218.  
  219. \node "net"
  220. \title "3-D Net"
  221. \next "newasprimary"
  222. \prev "negmono"
  223. \{ \tc 15 Net \} - Generates '3-D' net.
  224.  
  225. \nw    
  226. Usage - '\{ \tc 15 net <hortilt> <vertilt> <spacing> <effect> <blackline>
  227.          <overlay>\} '
  228.     
  229. \{ \tc 15 Horizontal Tilt: - 100 to 100
  230. Vertical Tilt:   - 100 to 100   
  231. Spacing:             1 to 200%
  232. Effect:              0 to 100%
  233. Black Line:      0 = no, 1 = yes
  234. Over Lay:        0 = no, 1 = yes\}
  235.     
  236. \{ \ts bu Sample Script\} :  
  237.  
  238. 'area';  
  239. options results;
  240. 'askprop "Horizontal Tilt" 0 -100 100';
  241. HT = result;
  242. 'askprop "Vertical Tilt" 0 -100 100';
  243. VT = result;
  244. 'askprop "Spacing" 100 0 200';
  245. spacing = result;
  246. 'askprop Effect 50 0 100';
  247. effect = result;
  248. 'askyn "White Line" "Black Line"';
  249. line = result;
  250. 'askyn "No Overlay" "Overlay"';
  251. overlay = result;
  252. options;
  253. '\{ \tc 15 net\} ' HT VT spacing effect line overlay;
  254.     
  255. * User Interface: \{ \tc 15   Process Panel
  256.                         Special Effects
  257.                             3-D Net\}
  258.  
  259. \endnode
  260.  
  261. \node "newasprimary"
  262. \title "New as primary buffer"
  263. \next "newblend"
  264. \prev "net"
  265. \{ \tc 15 Newasprimary \} - Creates a new buffer as the primary buffer.
  266.  
  267. \nw    
  268. Usage - '\{ \tc 15 newasprimary <filename>\} '
  269.     
  270. \{ \ts bu Sample Script\} :
  271.     
  272. options results;
  273. '\{ \tc 15 newprimary imagefile\} ';
  274. buffnumber = result;
  275. options;
  276.  
  277. \endnode
  278.  
  279. \node "newblend"
  280. \title "New Blend"
  281. \next "newbrush"
  282. \prev "newasprimary"
  283. \{ \tc 15 Newblend \} - Selects a buffer as the current blend control buffer.
  284.  
  285. Makes the selected buffer the current blend.
  286.     
  287. \nw    
  288. Usage - '\{ \tc 15 newblend <buffernumber>\} '
  289.     
  290. \{ \ts bu Sample Script\} :
  291.   
  292. '\{ \tc 15 newblend 4\} ';
  293. 'area';
  294. 'merge';
  295.     
  296. \endnode
  297.  
  298. \node "newbrush"
  299. \title "New Brush"
  300. \next "newbuf"
  301. \prev "newblend"
  302. \{ \tc 15 Newbrush \} - Selects a buffer as the current brush for painting.
  303.  
  304. \nw    
  305. Usage - '\{ \tc 15 newbrush <buffernumber>\} '
  306.     
  307. \{ \ts bu Sample Script\} :
  308. /* arexx newbrush Example */
  309. address('IM_Port');
  310. '\{ \tc 15 newbrush 3\} ';
  311. 'newline';
  312. 'move 0 0';
  313. 'draw 320 200 250';
  314. 'stroke';
  315. 'finish';
  316.  
  317. \endnode
  318.  
  319. \node "newbuf"
  320. \title "New Buffer"
  321. \next "newcurrent"
  322. \prev "newbrush"
  323. \{ \tc 15 Newbuf \} - Creates a new buffer.  This command will also return
  324. the buffer number of the newly created buffer.
  325.  
  326. \nw    
  327. Usage - '\{ \tc 15 newbuf <Xdim> <Ydim> [name] [MASK]\} '
  328.     
  329. \{ \ts bu Sample Script\} :
  330.     
  331. '\{ \tc 15 newbuf 640 400 mynewbuffer\} ';
  332.     
  333. * User Interface: \{ \tc 15   Buffer Panel
  334.                         New Buffer\}
  335.  
  336. \endnode
  337.  
  338. \node "newcurrent"
  339. \title "New Current"
  340. \next "newline"
  341. \prev "newbuf"
  342. \{ \tc 15 Newcurrent \} - Specifies a new current buffer.
  343.  
  344. \nw    
  345. Usage - '\{ \tc 15 newcurrent <#>\} '
  346.     
  347. \{ \ts bu Sample Script\} :
  348.     
  349. '\{ \tc 15 newcurrent 3\} ';
  350.     
  351. * User Interface: \{ \tc 15   Buffer Panel
  352.                          Select Primary Buffer\}
  353.  
  354.  
  355. \endnode
  356.  
  357. \node "newline"
  358. \title "Newline"
  359. \next "newsecondary"
  360. \prev "newcurrent"
  361. \{ \tc darkblue Newline \} - Specifies the beginning of a new line for painting.
  362. This command should be used in conjunction with the \{ \ts b move, draw, \}
  363. and \{ \ts b stroke \} commands to paint images using ARexx scripts.
  364.  
  365. \nw    
  366. Usage - '\{ \tc 15 newline\} '
  367.     
  368. \{ \ts bu Sample Script\} :
  369. /* arexx Painting Example */
  370. address('IM_Port');
  371. options results;
  372. 'askprop "Initial X Position: " 100 0 320';
  373. x1 = result;
  374. 'askprop "Initial Y Position: "100 0 200';
  375. y1 = result;
  376. 'askprop "Final X Position: " 100 0 320';
  377. x2 = result;
  378. 'askprop "Final Y Position: " 100 0 200';
  379. y2 = result;
  380. 'askprop "Specify the Pressure Amount: " 100 0 255';
  381. press = result;
  382. options;
  383. '\{ \tc darkblue newline\} ';
  384. 'move ' x1 y1;
  385. 'draw ' x2 y2 press;
  386. 'stroke';
  387. 'finish';
  388.  
  389. Related ARexx Commands: \{ \ts b \link " move " "move"
  390.                         \link " draw " "imdoc:hlp_arexx6/draw"
  391.                         \link "stroke" "imdoc:hlp_arexx11/stroke" \}
  392.  
  393. * User Interface: \{ \tc 15   Paint Panel
  394.                          Line Draw\}
  395.  
  396. \endnode
  397.  
  398. \node "newsecondary"
  399. \title "New Secondary"
  400. \next "newtargetted"
  401. \prev "newline"
  402. \{ \tc 15 Newsecondary \} - Specifies a new secondary buffer.
  403.  
  404. \nw    
  405. Usage - '\{ \tc 15 newsecondary <#>\} '
  406.     
  407. \{ \ts bu Sample Script\} :
  408.     
  409. '\{ \tc 15 newsecondary 3\} ';
  410.     
  411. * User Interface: \{ \tc 15   Buffer Panel
  412.                         Select Secondary Buffer\}
  413.  
  414. \endnode
  415.  
  416. \node "newtargetted"
  417. \title "New Targetted"
  418. \next "obuffers"
  419. \prev "newsecondary"
  420. \{ \tc 15 Newtargetted \} - Creates a new buffer and prompts the user for its
  421. target.
  422.  
  423. \nw    
  424. Usage - '\{ \tc 15 newtargetted <xw> <yw> <name> [mask]\} '
  425.     
  426. \{ \tc 15 XW:    - image width
  427. YW     - image height
  428. Name:  Name of new buffer
  429. Mask:  mask\} 
  430.     
  431. \{ \ts bu Sample Script\} :
  432.     
  433. '\{ \tc 15 newtargetted 640 400 mynewbuff mask\} ';
  434.  
  435. \endnode
  436.  
  437. \node "obuffers"
  438. \title "Other Buffers"
  439. \next "oil"
  440. \prev "newtargetted"
  441. \{ \tc 15 Obuffers \} - Returns all buffers except the primary  buffer.
  442.  
  443. \nw    
  444. Usage - '\{ \tc 15 obuffers\} '
  445.     
  446. \{ \ts bu Sample Script\} :
  447.     
  448. options results;
  449. '\{ \tc 15 obuffers\} ';
  450. buffs = result;
  451. options;
  452. parse var buffs buffname','buffnumber;
  453.  
  454. See Also: \{ \ts b \link "Buffers  " "hlp_arexx5/buffers"
  455.           \link "Sbuffers " "hlp_arexx10/sbuffers"
  456.           \link "Current  " "hlp_arexx6/current"
  457.           \link "Secondary" "hlp_arexx10/secondary"\}
  458.           
  459. \endnode
  460.  
  461. \node "oil"
  462. \title "Oil"
  463. \next "oval"
  464. \prev "obuffers"
  465. \{ \tc 15 Oil \} - Gives a selected region the appearance of an oil painting.
  466.  
  467. \nw    
  468. Usage - '\{ \tc 15 oil\} '
  469.     
  470. \{ \ts bu Sample Script\} :
  471.     
  472. 'area';
  473. '\{ \tc 15 oil\} ';
  474.     
  475. * User Interface: \{ \tc 15   Process Panel
  476.                         Special Effects
  477.                             Oil Brushed\}
  478.                             
  479. \endnode
  480.  
  481. \node "oval"
  482. \title "Oval"
  483. \next "pad"
  484. \prev "oil"
  485. \{ \tc 15 Oval \} - Defines an elliptical mask region.
  486.  
  487. \nw    
  488. Usage - '\{ \tc 15 oval <Xcenter> <Ycenter> <Xradius> <Yradius>\} '
  489.     
  490. \{ \ts bu Sample Script\} :
  491.     
  492. '\{ \tc 15 oval 60 100 165 190\} ';
  493. 'contrast 90';
  494.  
  495. \endnode
  496.  
  497. \node "pad"
  498. \title "Pad"
  499. \next "padcanvas"
  500. \prev "oval"
  501. \{ \tc 15 Pad \} - Creates a new buffer that is padded at the bottom or right.
  502.  
  503. Creates a new buffer which is padded to the right or bottom so that it will
  504. be displayed in the correct aspect ratio on the Amiga monitor.
  505.     
  506. \nw    
  507. Usage - '\{ \tc 15 pad [newname]\} '
  508.     
  509. \{ \ts bu Sample Script\} :
  510.     
  511. 'area';
  512. '\{ \tc 15 pad Padded\} ';
  513.     
  514. * User Intrerface: \{ \tc 15 Process Panel 
  515.                         Re-sizing and Clipping
  516.                             Pad Canvas\}
  517.  
  518. \endnode
  519.  
  520. \node "padcanvas"
  521. \title "Pad Canvas"
  522. \next "pal"
  523. \prev "pad"
  524. \{ \tc 15 Padcanvas \} - Pads the selected area to a new size.
  525.  
  526. Pads a selected area to a new size returning the buffer number.
  527.  
  528. \nw    
  529. Usage - '\{ \tc 15 padcanvas <Xsize> <Ysize> <Position> <NewName>\} '
  530.     
  531. \{ \tc 15 Position:   1 = Top Left
  532.             2 = Top Center
  533.             3 = Top Right
  534.             4 = Middle Left
  535.             5 = Middle Center
  536.             6 = Middle Right
  537.             7 = Bottom Left
  538.             8 = Bottom Center
  539.             9 = Bottom Right\}
  540.                 
  541. \{ \ts bu Sample Script\} :
  542.     
  543. 'entire';
  544. '\{ \tc 15 padcanvas 400 400 5 NewClip\} ';
  545.  
  546. * User Interface: \{ \tc 15  Process Panel
  547.                        Re-sizing and Clipping
  548.                           Pad Canvas\}
  549.  
  550. \endnode
  551.  
  552. \node "pal"
  553. \title "Pal Modes"
  554. \next "palette64"
  555. \prev "padcanvas"
  556. \{ \tc 15 Pal \} - Reports 0 for NTSC and 1 for PAL modes.
  557.  
  558. \nw    
  559. Usage - '\{ \tc 15 pal\} '
  560.     
  561. \{ \ts bu Sample Script\} :
  562.     
  563. options results;
  564. '\{ \tc 15 pal\} ';
  565. mode = result;
  566. options;
  567.  
  568. \endnode
  569.  
  570. \node "palette64"
  571. \title "Load 64 Color Palette"
  572. \next "paletteext64"
  573. \prev "pal"
  574. \{ \tc 15 Palette64/Paleteext64 \} - Loads a 64 color palette.
  575.     
  576. Loads a 64 color palette file for use in HAM-E and other small palette
  577. renders.  Only the first 64 colors of IM's 256 color palette will change.
  578.     
  579. \nw    
  580. Usage - '\{ \tc 15 palette64 <filename>\} '
  581.     
  582. \{ \ts bu Sample Script\} :
  583.        
  584. options results;
  585. 'askstring "File Name:" "64colorpalettefile"'name;
  586. name = result;
  587. options;
  588. '\{ \tc 15 palette64\} ' name;
  589.     
  590. See Also: \{ \tc 15 \link "blendload      " "hlp_arexx5/blendload"
  591.           \link "load           " "hlp_arexx8/load" 
  592.           \link "loadasblend    " "hlp_arexx8/loadasblend"
  593.           \link "loadasbrush    " "hlp_arexx8/loadasbrush"
  594.           \link "loadasprimary  " "hlp_arexx8/loadasprimary"
  595.           \link "loadassecondary" "hlp_arexx8/loadassecondary"
  596.           \link "loadimask      " "hlp_arexx8/loadimask"     
  597.           \link "loadmask       " "hlp_arexx8/loadmask"\}
  598.  
  599. \endnode 
  600.  
  601. \node "paletteext64"
  602. \title "Paletteext64"
  603. \next "palettedefs"
  604. \prev "palette64"
  605. \{ \tc 15 Palette64/Paleteext64 \} - Loads a 64 color palette.
  606.     
  607. Loads a 64 color palette file for use in HAM-E and other small palette
  608. renders.  Only the first 64 colors of IM's 256 color palette will change.
  609.     
  610. \nw    
  611. Usage - '\{ \tc 15 palette64 <ext name>\} '
  612.     
  613. \{ \ts bu Sample Script\} :
  614.        
  615. options results;
  616. 'askstring "Ext Name:" "64colorpaletteext"'name;
  617. name = result;
  618. options;
  619. '\{ \tc 15 paletteext64\} ' name;
  620.  
  621. \endnode
  622.  
  623. \node "palettedefs"
  624. \title "Palette Definitions"
  625. \next "paletteext"
  626. \prev "paletteext64"
  627. \{ \tc 15 Palettedefs \} - Returns path and extension of a saved palette.
  628.  
  629. \nw    
  630. Usage - '\{ \tc 15 palettedefs\} '    
  631.     
  632. \{ \ts bu Sample Script\} :
  633.     
  634. options results;
  635. '\{ \tc 15 palettedefs\} ';
  636. info = result;
  637. parse var info path ','extension;
  638. options;
  639.  
  640. See also: \{ \ts b \link "blenddefs " "hlp_arexx5/blenddefs"
  641.           \link "imagedefs " "hlp_arexx7/imagedefs"    
  642.           \link "macrodefs " "hlp_arexx8/macrodefs"
  643.           \link "renderdefs" "hlp_arexx10/renderdefs"\}
  644.     
  645. \endnode
  646.  
  647. \node "paletteext"
  648. \title "Palette Ext"
  649. \next "paletteload"
  650. \prev "palettedefs"
  651. \{ \tc 15 Paletteext \} - Sets a new extension for 64 color palette files.
  652.  
  653. \nw    
  654. Usage - '\{ \tc 15 paletteext <newext>\} '
  655.     
  656. \{ \ts bu Sample Script\} :
  657.           
  658. options results;
  659. 'askstring "New Extension:" "pal"'name;
  660. name = result;
  661. options;
  662. '\{ \tc 15 paletteext\} ' name;         
  663.  
  664. See Also: \{ \ts b \link "blendext " "hlp_arexx5/blendext"
  665.           \link "imageext " "hlp_arexx7/imageext"
  666.           \link "macroext " "hlp_arexx8/macroext"
  667.           \link "renderext" "hlp_arexx10/renderext"\}
  668.  
  669. * User Interface: \{ \tc 15  Setup Panel
  670.                        Palette Ext\}
  671.  
  672. \endnode
  673.  
  674. \node "paletteload"
  675. \title "Palette Load"
  676. \next "palettepath"
  677. \prev "paletteext"
  678. \{ \tc 15 Paletteload \} - Sets a new path for loading and saving palettes.
  679.  
  680. \nw   
  681. Usage - '\{ \tc 15 paletteload <name>\} '
  682.     
  683. \{ \ts bu Sample Script\} :
  684.      
  685. options results;
  686. 'askstring "File Name:" "palettefile"'name;
  687. name = result;
  688. options;
  689. '\{ \tc 15 paletteload\} ' name;
  690.    
  691. See Also: \{ \ts b \link "blendload      " "hlp_arexx5/blendload"
  692.           \link "load           " "hlp_arexx8/load" 
  693.           \link "loadasblend    " "hlp_arexx8/loadasblend"
  694.           \link "loadasbrush    " "hlp_arexx8/loadasbrush"
  695.           \link "loadasprimary  " "hlp_arexx8/loadasprimary"
  696.           \link "loadassecondary" "hlp_arexx8/loadassecondary"
  697.           \link "loadimask      " "hlp_arexx8/loadimask"  
  698.           \link "loadmask       " "hlp_arexx8/loadmask"\}
  699.  
  700. \endnode
  701.  
  702. \node "palettepath"
  703. \title "Palette Path"
  704. \next "pcontask"
  705. \prev "paletteload"
  706. \{ \tc 15 Palettepath \} - Sets a new path for loading and saving palettes.
  707.  
  708. \nw    
  709. Usage - '\{ \tc 15 palettepath <newpath>\} '
  710.     
  711. \{ \ts bu Sample Script\} :
  712.      
  713. '\{ \tc 15 palettepath work:palettes\} ';
  714.     
  715. See Also: \{ \ts b \link "blendpath  " "hlp_arexx5/blendpath"  
  716.           \link "imagepath  " "hlp_arexx7/imagepath"
  717.           \link "macropath  " "hlp_arexx8/macropath"
  718.           \link "renderpath " "hlp_arexx10/renderpath"\}
  719.                 
  720. * User Interface: \{ \tc 15    Setup Panel
  721.                           Palette Path\}
  722.  
  723. \endnode
  724.  
  725. \node "pcontask"
  726. \title "pcontask"
  727. \next "pcontrol"
  728. \prev "paletteload"
  729. \{ \tc 15 Pcontask \} - Returns the palette control flag value for that
  730. register.
  731.  
  732. \nw    
  733. Usage - '\{ \tc 15 pcontask <register>\} '
  734.  
  735.  
  736. \{ \ts bu Sample Script\} :
  737.      
  738. '\{ \tc 15 pcontask 123\} ';
  739.     
  740. \endnode
  741.  
  742. \node "pcontrol"
  743. \title "pcontrol"
  744. \next "pixelize"
  745. \prev "pcontask"
  746. \{ \tc 15 Pcontrol \} - This sets the render state for a register as per AGA
  747. palette screen.
  748.  
  749. \nw    
  750. Usage - '\{ \tc 15 pcontrol <register> <state>\} '
  751.  
  752. \{ \ce \ts b State Values\}
  753.        0 =  Normal
  754.        1 =  Usable but not changable by the renderer
  755.        2 =  Skip / unusable
  756.  
  757. \{ \ts bu Sample Script\} :
  758.      
  759. '\{ \tc 15 pcontask 123 1\} ';
  760.  
  761. \endnode
  762.  
  763. \node "pixelize"
  764. \title "Pixelize / Pix"
  765. \next "plugin"
  766. \prev "palettepath"
  767. \{ \tc 15 Pixelize / Pix \} - Pixelizes a selected region (Pix).
  768.  
  769. \nw    
  770. Usage - '\{ \tc 15 pixelize\} '
  771.     
  772. \{ \ts bu Sample Script\} :
  773.    
  774. 'area';
  775. '\{ \tc 15 pixelize\} ';
  776.  
  777. * User Interface: \{ \tc 15   Process Panel 
  778.                         Special Effect
  779.                             Pixelize\}
  780.  
  781. \endnode
  782.  
  783. \node "plugin"
  784. \title "Plug in"
  785. \next "poster"
  786. \prev "pixelize"
  787. \{ \tc 15 Plugin \} - Returns a single pointer in hexadecimal format.
  788.  
  789. \nw    
  790. Usage - '\{ \tc 15 plugin <buffer number> \} '
  791.     
  792. \{ \ts bu Sample Script\} :
  793.      
  794. options results; 
  795. '\{ \tc 15 plugin\} ';
  796. plugptr = result; 
  797. options; 
  798. 'backuptoundo';
  799. address command; 
  800. 'cmpi:myfile '||plugptr;
  801. address(prtnme);
  802. 'redraw';
  803.  
  804. See Also: \{ \ts b \link "Jackin" "hlp_arexx8/jackin"\}
  805.     
  806. \endnode
  807.  
  808. \node "poster"
  809. \title "Posterize / Poster"
  810. \next "perspect"
  811. \prev "plugin"
  812. \{ \tc 15 Posterize / Poster \} - Posterizes a selected region (Poster).
  813.  
  814. Contours a specific region to a particular set of number of levels that are
  815. fitted within the dynamic range of  the selected area.  This effect is
  816. similar to what you might see on a \{ \ts i hard rock \} or \{ \ts i
  817. psychedelic \} poster.
  818.     
  819. \nw    
  820. Usage - '\{ \tc 15 posterize <levels>\} '
  821.         '\{ \tc 15 poster <levels>\} '
  822.            
  823. \{ \tc 15 Levels: 1 to 20\}       
  824.             
  825. \{ \ts bu Sample Script\} :
  826.     
  827. 'area';
  828. '\{ \tc 15 posterize 89\} ';
  829.     
  830. * User Interface: \{ \tc 15   Process Panel 
  831.                         Special Effects
  832.                             Posterize\}
  833.  
  834. \endnode
  835.  
  836. \node "perspect"
  837. \title "Perspective Placement"
  838. \next "previousmask"
  839. \prev "poster"
  840. Perspective placement will place the secondary buffer image onto the primary
  841. buffer using a 3-dimensional perspective projection.  All of the parameters
  842. are required to insure proper operation.
  843.            
  844. \nw    
  845. Usage - '\{ \tc 15 perspect [Xrotn=N.n] [Yrotn=N.n] [Zrotn=N.n]
  846.                 [Xtrans=N.n] [Ytrans=N.n] [Ztrans=N.n]
  847.                 [Xscale=N.n] [Yscale=N.n] [Zscale=N.n]\} ';
  848.                             
  849. \{ \tc 15 X Rotn      : rotation about the X axis (pitch)   (in degrees)
  850. Y Rotn      : rotation about the Y axis (yaw)
  851. Z Rotn      : rotation about the Z axis (roll)
  852. X Translate : movement left and right
  853. Y Translate : movement up and down
  854. Z Translate : depth movement into the screen
  855. X Scale     : horizontal stretching
  856. Y Scale     : vertical stretching
  857. Z Scale     : depth stretching\}
  858.        
  859. \{ \ts bu Sample Script\} :
  860.     
  861. address('IM_Port');
  862. 'autoredraw 0';
  863. '\{ \tc 15 perspect Xr=330 Yr=0 Zr=0 Xt=405 Yt=-240 Zt=656 Xs=300 Ys=300
  864.   Zs=100\} ';
  865.  do i=1 to 10
  866.    YR=i*36;
  867.    XT=405-i*80;
  868.    YT=-240+i*36;
  869.    ' perspect Yr='||YR||' Xt='||XT||' Yt='||YT;
  870.    end
  871.  'redraw';
  872. 'finish';
  873.     
  874.     
  875. * User Interface: \{ \tc 15  Compose
  876.                      Special Compositions
  877.                          Perspective Placement\} 
  878.  
  879. \endnode
  880.  
  881. \node "previousmask"
  882. \title "Previous Mask"
  883. \next "pseudo"
  884. \prev "perspect"
  885. \{ \tc 15 Previousmask \} - Selects region based on the previous mask.
  886.     
  887. Method of area selection, enabling the user to repeatedly select the same
  888. area.
  889.     
  890. \nw    
  891. Usage - '\{ \tc 15 previousmask\} '
  892.     
  893. \{ \ts bu Sample Script\} :
  894.     
  895. '\{ \tc 15 previousmask\} ';
  896. 'contrast 89';
  897.     
  898. See also: \{ \ts b \link "entire  " "hlp_arexx7/entire"
  899.           \link "oval    " "hlp_arexx9/oval"        
  900.           \link "rect    " "hlp_arexx10/rect"
  901.           \link "rectarea" "hlp_arexx10/rectarea"\}
  902.  
  903. \endnode
  904.  
  905. \node "pseudo"
  906. \title "Pseudo"
  907. \next ""
  908. \prev "previousmask"
  909. \{ \tc 15 Pseudo \} - Changes a selected region to pseudo color.
  910.  
  911. Changes the image colors based on the monochrome brightness.  Transforming
  912. dark pixels to blue (cold), medium pixels to green (warm), and bright pixels
  913. to red (hot).
  914.     
  915. \nw    
  916. Usage - '\{ \tc 15 pseudo\} '
  917.     
  918. \{ \ts bu Sample Script\} :
  919.     
  920. 'area';
  921. '\{ \tc 15 pseudo\} ';
  922.     
  923. See Also: \{ \ts b \link "False" "hlp_arexx7/false"\}
  924.     
  925. * User Interface: \{ \tc 15   Process Panel
  926.                         Special Effects
  927.                             False Color\}
  928.  
  929. \endnode
  930.  
  931.